package cn.cdeden.aiqa.service;

import cn.cdeden.aiqa.domain.WikiHelper;
import cn.cdeden.aiqa.domain.bo.ChatGptHelperdQueryParam;
import cn.cdeden.aiqa.domain.bo.ChatgptQuestionUserDto;
import cn.cdeden.aiqa.domain.vo.WikiHelperVo;
import cn.cdeden.aiqa.domain.bo.WikiHelperBo;
import cn.cdeden.common.core.domain.R;
import cn.cdeden.common.core.utils.page.TableDataInfo;
import cn.cdeden.common.mybatis.core.page.PageQuery;
import org.springframework.data.domain.Pageable;

import java.util.Collection;
import java.util.List;

/**
 * 智能体管理Service接口
 *
 * @author Nick
 * @date 2025-02-13
 */
public interface IWikiHelperService {

    /**
     * 查询智能体管理
     *
     * @param id 主键
     * @return 智能体管理
     */
    WikiHelperVo queryById(Long id);

    /**
     * 分页查询智能体管理列表
     *
     * @param bo        查询条件
     * @param pageQuery 分页参数
     * @return 智能体管理分页列表
     */
    TableDataInfo<WikiHelperVo> queryPageList(WikiHelperBo bo, PageQuery pageQuery);

    /**
     * 查询符合条件的智能体管理列表
     *
     * @param bo 查询条件
     * @return 智能体管理列表
     */
    List<WikiHelperVo> queryList(WikiHelperBo bo);

    /**
     * 新增智能体管理
     *
     * @param bo 智能体管理
     * @return 是否新增成功
     */
    Boolean insertByBo(WikiHelperBo bo);

    /**
     * 修改智能体管理
     *
     * @param bo 智能体管理
     * @return 是否修改成功
     */
    Boolean updateByBo(WikiHelperBo bo);

    /**
     * 校验并批量删除智能体管理信息
     *
     * @param ids     待删除的主键集合
     * @param isValid 是否进行有效性校验
     * @return 是否删除成功
     */
    Boolean deleteWithValidByIds(Collection<Long> ids, Boolean isValid);

    /**
     * 给用户添加助手
     * @param questionUserDto
     */
    void addHelper(ChatgptQuestionUserDto questionUserDto);

    /**
     * 去除用户的助手
     * @param questionUserDto
     */
    void delHelper(ChatgptQuestionUserDto questionUserDto);

    /**
     * 分页查询列表
     * @param query
     * @param pageable
     * @return
     */
    TableDataInfo<WikiHelperVo> select(ChatGptHelperdQueryParam query, Pageable pageable);

    /**
     * 查询所有（基于用户）
     * @param query
     * @return
     */
    R<List<WikiHelperVo>> selectAll(ChatGptHelperdQueryParam query);
}
